home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.1
/
objcopy.1
< prev
next >
Wrap
Text File
|
1995-07-25
|
18KB
|
265 lines
oooobbbbjjjjccccooooppppyyyy((((1111)))) ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444)))) oooobbbbjjjjccccooooppppyyyy((((1111))))
NNNNAAAAMMMMEEEE
objcopy - copy and translate object files
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
oooobbbbjjjjccccooooppppyyyy
[----FFFF _b_f_d_n_a_m_e |||| --------ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e]
[----IIII _b_f_d_n_a_m_e |||| --------iiiinnnnppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e]
[----OOOO _b_f_d_n_a_m_e |||| --------oooouuuuttttppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e]
[----RRRR _s_e_c_t_i_o_n_n_a_m_e |||| --------rrrreeeemmmmoooovvvveeee----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e]
[----SSSS |||| --------ssssttttrrrriiiipppp----aaaallllllll] [----gggg |||| --------ssssttttrrrriiiipppp----ddddeeeebbbbuuuugggg]
[----NNNN _s_y_m_b_o_l_n_a_m_e | --strip-symbol=_s_y_m_b_o_l_n_a_m_e]
[----xxxx |||| --------ddddiiiissssccccaaaarrrrdddd----aaaallllllll] [----XXXX |||| --------ddddiiiissssccccaaaarrrrdddd----llllooooccccaaaallllssss]
[----bbbb _b_y_t_e | --------bbbbyyyytttteeee====_b_y_t_e]
[----iiii _i_n_t_e_r_l_e_a_v_e | --------iiiinnnntttteeeerrrrlllleeeeaaaavvvveeee====_i_n_t_e_r_l_e_a_v_e]
[--------ggggaaaapppp----ffffiiiillllllll====_v_a_l] [--------ppppaaaadddd----ttttoooo====_a_d_d_r_e_s_s] [--------sssseeeetttt----ssssttttaaaarrrrtttt====_v_a_l]
[--------aaaaddddjjjjuuuusssstttt----ssssttttaaaarrrrtttt====_i_n_c_r] [--------aaaaddddjjjjuuuusssstttt----vvvvmmmmaaaa====_i_n_c_r]
[--------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa====_s_e_c_t_i_o_n{=,+,-}_v_a_l]
[--------aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss] [--------nnnnoooo----aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss]
[--------sssseeeetttt----sssseeeeccccttttiiiioooonnnn----ffffllllaaaaggggssss====_s_e_c_t_i_o_n=_f_l_a_g_s]
[--------aaaadddddddd----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e=_f_i_l_e_n_a_m_e] [----vvvv |||| --------vvvveeeerrrrbbbboooosssseeee]
[----VVVV |||| --------vvvveeeerrrrssssiiiioooonnnn] [--------hhhheeeellllpppp] iiiinnnnffffiiiilllleeee [oooouuuuttttffffiiiilllleeee]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The GNU oooobbbbjjjjccccooooppppyyyy utility copies the contents of an object
file to another. oooobbbbjjjjccccooooppppyyyy uses the GNU BFD Library to read
and write the object files. It can write the destination
object file in a format different from that of the source
object file. The exact behavior of oooobbbbjjjjccccooooppppyyyy is controlled by
command-line options.
oooobbbbjjjjccccooooppppyyyy creates temporary files to do its translations and
deletes them afterward. oooobbbbjjjjccccooooppppyyyy uses BFD to do all its
translation work; it knows about all the formats BFD knows
about, and thus is able to recognize most formats without
being told explicitly.
oooobbbbjjjjccccooooppppyyyy can be used to generate S-records by using an output
target of ssssrrrreeeecccc (e.g., use ----OOOO ssssrrrreeeecccc))))....
oooobbbbjjjjccccooooppppyyyy can be used to generate a raw binary file by using
an output target of bbbbiiiinnnnaaaarrrryyyy (e.g., use ----OOOO bbbbiiiinnnnaaaarrrryyyy)))).... When
oooobbbbjjjjccccooooppppyyyy generates a raw binary file, it will essentially
produce a memory dump of the contents of the input object
file. All symbols and relocation information will be
discarded. The memory dump will start at the virtual
address of the lowest section copied into the output file.
When generating an S-record or a raw binary file, it may be
helpful to use ----SSSS to remove sections containing debugging
information. In some cases ----RRRR will be useful to remove
sections which contain information which is not needed by
Page 1 (printed 7/12/95)
oooobbbbjjjjccccooooppppyyyy((((1111)))) ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444)))) oooobbbbjjjjccccooooppppyyyy((((1111))))
the binary file.
_i_n_f_i_l_e and _o_u_t_f_i_l_e are the source and output files
respectively. If you do not specify _o_u_t_f_i_l_e, oooobbbbjjjjccccooooppppyyyy
creates a temporary file and destructively renames the
result with the name of the input file.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----IIII _b_f_d_n_a_m_e, --------iiiinnnnppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e
Consider the source file's object format to be _b_f_d_n_a_m_e,
rather than attempting to deduce it.
----OOOO _b_f_d_n_a_m_e, --------oooouuuuttttppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e
Write the output file using the object format _b_f_d_n_a_m_e.
----FFFF _b_f_d_n_a_m_e, --------ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e
Use _b_f_d_n_a_m_e as the object format for both the input and
the output file; i.e. simply transfer data from source
to destination with no translation.
----RRRR _s_e_c_t_i_o_n_n_a_m_e, --------rrrreeeemmmmoooovvvveeee----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e
Remove the named section from the file. This option
may be given more than once. Note that using this
option inappropriately may make the output file
unusable.
----SSSS, --------ssssttttrrrriiiipppp----aaaallllllll
Do not copy relocation and symbol information from the
source file.
----gggg, --------ssssttttrrrriiiipppp----ddddeeeebbbbuuuugggg
Do not copy debugging symbols from the source file.
----NNNN _s_y_m_b_o_l_n_a_m_e, --------ssssttttrrrriiiipppp----ssssyyyymmmmbbbboooollll====_s_y_m_b_o_l_n_a_m_e
Do not copy symbol _s_y_m_b_o_l_n_a_m_e from the source file.
This option may be given more than once, and may be
combined with other strip options.
----xxxx, --------ddddiiiissssccccaaaarrrrdddd----aaaallllllll
Do not copy non-global symbols from the source file.
----XXXX, --------ddddiiiissssccccaaaarrrrdddd----llllooooccccaaaallllssss
Do not copy compiler-generated local symbols. (These
usually start with "L" or ".").
----bbbb _b_y_t_e, --------bbbbyyyytttteeee====_b_y_t_e
Keep only every _b_y_t_eth byte of the input file (header
data is not affected). _b_y_t_e can be in the range from 0
to the interleave-1. This option is useful for
creating files to program ROMs. It is typically used
with an srec output target.
Page 2 (printed 7/12/95)
oooobbbbjjjjccccooooppppyyyy((((1111)))) ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444)))) oooobbbbjjjjccccooooppppyyyy((((1111))))
----iiii _i_n_t_e_r_l_e_a_v_e, --------iiiinnnntttteeeerrrrlllleeeeaaaavvvveeee====_i_n_t_e_r_l_e_a_v_e
Only copy one out of every _i_n_t_e_r_l_e_a_v_e bytes. Which one
to copy is selected by the ----bbbb or --------bbbbyyyytttteeee option. The
default is 4. The interleave is ignored if neither ----bbbb
nor --------bbbbyyyytttteeee is given.
--------ggggaaaapppp----ffffiiiillllllll====_v_a_l
Fill gaps between sections with _v_a_l. This is done by
increasing the size of the section with the lower
address, and filling in the extra space created with
_v_a_l.
--------ppppaaaadddd----ttttoooo====_a_d_d_r_e_s_s
Pad the output file up to the virtual address _a_d_d_r_e_s_s.
This is done by increasing the size of the last
section. The extra space is filled in with the value
specified by --------ggggaaaapppp----ffffiiiillllllll (default zero).
--------sssseeeetttt----ssssttttaaaarrrrtttt====_v_a_l
Set the start address of the new file to _v_a_l. Not all
object file formats support setting the start address.
--------aaaaddddjjjjuuuusssstttt----ssssttttaaaarrrrtttt====_i_n_c_r
Adjust the start address by adding _i_n_c_r. Not all
object file formats support setting the start address.
--------aaaaddddjjjjuuuusssstttt----vvvvmmmmaaaa====_i_n_c_r
Adjust the address of all sections, as well as the
start address, by adding _i_n_c_r. Some object file
formats do not permit section addresses to be changed
arbitrarily. Note that this does not relocate the
sections; if the program expects sections to be loaded
at a certain address, and this option is used to change
the sections such that they are loaded at a different
address, the program may fail.
--------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa====_s_e_c_t_i_o_n{=,+,-}_v_a_l
Set or adjust the address of the named _s_e_c_t_i_o_n. If =
is used, the section address is set to _v_a_l. Otherwise,
_v_a_l is added to or subtracted from the section address.
See the comments under --------aaaaddddjjjjuuuusssstttt----vvvvmmmmaaaa, above. If _s_e_c_t_i_o_n
does not exist in the input file, a warning will be
issued, unless --------nnnnoooo----aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss is used.
--------aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss
If --------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa is used, and the named section
does not exist, issue a warning. This is the default.
--------nnnnoooo----aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss
Do not issue a warning if --------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa is used,
even if the named section does not exist.
Page 3 (printed 7/12/95)
oooobbbbjjjjccccooooppppyyyy((((1111)))) ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444)))) oooobbbbjjjjccccooooppppyyyy((((1111))))
--------sssseeeetttt----sssseeeeccccttttiiiioooonnnn----ffffllllaaaaggggssss====_s_e_c_t_i_o_n=_f_l_a_g_s
Set the flags for the named section. The _f_l_a_g_s
argument is a comma separated string of flag names.
The recognized names are _a_l_l_o_c, _l_o_a_d, _r_e_a_d_o_n_l_y, _c_o_d_e,
_d_a_t_a, and _r_o_m. Not all flags are meaningful for all
object file formats.
--------aaaadddddddd----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e=_f_i_l_e_n_a_m_e
Add a new section named _s_e_c_t_i_o_n_n_a_m_e while copying the
file. The contents of the new section are taken from
the file _f_i_l_e_n_a_m_e. The size of the section will be the
size of the file. This option only works on file
formats which can support sections with arbitrary
names.
----vvvv, --------vvvveeeerrrrbbbboooosssseeee
Verbose output: list all object files modified. In the
case of archives, "oooobbbbjjjjccccooooppppyyyy ----VVVV" lists all members of the
archive.
----VVVV, --------vvvveeeerrrrssssiiiioooonnnn
Show the version number of oooobbbbjjjjccccooooppppyyyy and exit.
--------hhhheeeellllpppp
Show a summary of the options to oooobbbbjjjjccccooooppppyyyy and exit.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
`bbbbiiiinnnnuuuuttttiiiillllssss' entry in iiiinnnnffffoooo; _T_h_e _G_N_U _B_i_n_a_r_y _U_t_i_l_i_t_i_e_s, Roland
H. Pesch (June 1993).
CCCCOOOOPPPPYYYYIIIINNNNGGGG
Copyright (c) 1993,1994 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies
of this manual provided the copyright notice and this
permission notice are preserved on all copies.
Permission is granted to copy and distribute modified
versions of this manual under the conditions for verbatim
copying, provided that the entire resulting derived work is
distributed under the terms of a permission notice identical
to this one.
Permission is granted to copy and distribute translations of
this manual into another language, under the above
conditions for modified versions, except that this
permission notice may be included in translations approved
by the Free Software Foundation instead of in the original
English.
Page 4 (printed 7/12/95)